package com.smart.community.property.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.smart.community.property.entity.GasFee;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.math.BigDecimal;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

/**
 * 燃气费Mapper接口
 * @author Wu.Liang
 * @since 2024-12-21
 */
@Mapper
public interface GasFeeMapper extends BaseMapper<GasFee> {
    
    /**
     * 根据房户ID和计费周期查询账单
     * @param householdId 房户ID
     * @param billingPeriod 计费周期
     * @return 账单信息
     */
    GasFee selectByHouseholdIdAndBillingPeriod(@Param("householdId") Long householdId,
                                               @Param("billingPeriod") String billingPeriod);
    
    /**
     * 根据房户ID查询最新的表读数
     * @param householdId 房户ID
     * @return 最新表读数
     */
    GasFee selectLatestReadingByHouseholdId(@Param("householdId") Long householdId);
    
    /**
     * 分页查询燃气费账单
     * @param page 分页参数
     * @param communityId 社区ID
     * @param paymentStatus 支付状态（0-未支付，1-已支付，2-逾期，3-部分支付）
     * @return 分页结果
     */
    IPage<GasFee> selectGasFeePage(Page<GasFee> page,
                                   @Param("communityId") Long communityId,
                                   @Param("paymentStatus") Integer paymentStatus);
    
    /**
     * 根据用户ID查询未缴费燃气费账单
     * @param userId 用户ID
     * @return 未缴费账单列表
     */
    List<GasFee> selectUnpaidGasFeesByUserId(@Param("userId") Long userId);
    
    /**
     * 更新燃气费支付状态
     * @param id 账单ID
     * @param paymentStatus 支付状态（0-未支付，1-已支付，2-逾期，3-部分支付）
     * @param paymentAmount 支付金额
     * @param paymentMethod 支付方式（1-现金，2-微信，3-支付宝，4-银行卡）
     * @param paymentTime 支付时间
     * @return 更新结果
     */
    int updatePaymentStatus(@Param("id") Long id,
                           @Param("paymentStatus") Integer paymentStatus,
                           @Param("paymentAmount") BigDecimal paymentAmount,
                           @Param("paymentMethod") Integer paymentMethod,
                           @Param("paymentTime") LocalDateTime paymentTime);
    
    /**
     * 获取燃气费统计信息
     * @param communityId 社区ID
     * @param year 年份
     * @return 统计信息
     */
    Map<String, Object> selectGasFeeStatistics(@Param("communityId") Long communityId,
                                               @Param("year") Integer year);
    
    /**
     * 批量生成燃气费账单
     * @param communityId 社区ID
     * @param billingPeriod 计费周期
     * @param unitPrice 燃气单价
     * @return 生成的账单数量
     */
    int batchGenerateGasFees(@Param("communityId") Long communityId,
                             @Param("billingPeriod") String billingPeriod,
                             @Param("unitPrice") BigDecimal unitPrice);
    
    /**
     * 查询逾期燃气费账单
     * @param communityId 社区ID
     * @param dueDate 到期日期
     * @return 逾期账单列表
     */
    List<GasFee> selectOverdueGasFees(@Param("communityId") Long communityId,
                                      @Param("dueDate") LocalDate dueDate);
    
    /**
     * 查询异常用量记录
     * @param communityId 社区ID
     * @param minUsage 最小异常用量
     * @param maxUsage 最大异常用量
     * @return 异常用量记录
     */
    List<GasFee> selectAbnormalUsageRecords(@Param("communityId") Long communityId,
                                            @Param("minUsage") BigDecimal minUsage,
                                            @Param("maxUsage") BigDecimal maxUsage);
} 